home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / gnustuff / tos / gdb / gdb_18b.zoo / gdb.man < prev    next >
Encoding:
Text File  |  1992-03-30  |  4.0 KB  |  99 lines
  1. NAME
  2.      gdb - Project GNU's DeBugger
  3.  
  4. SYNOPSIS
  5.      gdb [ options ]   See documentation mentioned below.
  6.  
  7. DESCRIPTION
  8.      gdb is a source level symbolic debugger for C programs,
  9.      created by Richard M. Stallman (rms) for the GNU Project,
  10.      and distributed by the Free Software Foundation.  Eventually
  11.      GNU (Gnu's Not Unix) will be a complete replacement for
  12.      Berkeley Unix, all of which everyone will be able to use
  13.      freely.  See the GNU Emacs man page for pointers to more
  14.      information.
  15.  
  16.      gdb has something of the flavor of dbx, but has more
  17.      features and power.  It can also be used to debug o/s ker-
  18.      nels, but needs to be configured differently for that task.
  19.  
  20.      Project GNU isn't using Unix man pages.  Its style of com-
  21.      plete documentation can be found by:
  22.  
  23.      The help and info commands inside gdb.
  24.  
  25.      In the Info system in GNU Emacs.  Type C-h i, and follow the
  26.      directions.  This is equivalent to the reference manual for
  27.      gdb, and has about 55 pages of text.
  28.  
  29.      gdb could be extended to work with other languages (e.g.
  30.      Pascal) and machines (e.g. encores).  If you like, copy the
  31.      sources and give it a try.  When you have it working send
  32.      diff -c's of the changed files to bug-gdb@prep.ai.mit.edu
  33.      (fuller details below), so they can benefit everyone.
  34.  
  35. DISTRIBUTION
  36.      gdb is free; anyone may redistribute copies of gdb to anyone
  37.      under the terms stated in the gdb General Public License, a
  38.      copy of which accompanies each copy of gdb, is readable with
  39.      the info command inside gdb, and which also appears in the
  40.      gdb reference manual.
  41.  
  42.      Copies of gdb may sometimes be received packaged with dis-
  43.      tributions of Unix systems, but it is never included in the
  44.      scope of any license covering those systems.  Such inclusion
  45.      would violate the terms on which distribution is permitted.
  46.      In fact, the primary purpose of the General Public License
  47.      is to prohibit anyone from attaching any other restrictions
  48.      to redistribution of gdb.
  49.  
  50.      You can order printed copies of the gdb reference manual for
  51.      $10.00/copy postpaid from the Free Software Foundation,
  52.      which develops GNU software (contact them for quantity
  53.      prices on the manual).  Their address is:
  54.          Free Software Foundation
  55.          1000 Mass Ave.
  56.          Cambridge, MA  02138
  57.      As with all software and publications from FSF, everyone is
  58.      permitted to make and distribute copies of the gdb reference
  59.      manual.  The TeX source to the gdb reference manual is also
  60.      included in the GNU Emacs source distribution.
  61.  
  62. OPTIONS
  63.      See documentation.
  64.  
  65. EXAMPLES
  66.      See documentation.
  67.  
  68. SEE ALSO
  69.      adb(1), sdb(1), dbx(1)
  70.  
  71. BUGS
  72.      There is a mailing list, bug-gdb@prep.ai.mit.edu on the
  73.      internet (ucbvax!prep.ai.mit.edu!bug-gdb on UUCPnet), for
  74.      reporting gdb bugs and fixes.  But before reporting some-
  75.      thing as a bug, please try to be sure that it really is a
  76.      bug, not a misunderstanding or a deliberate feature.  We ask
  77.      you to read the section ``Reporting Emacs Bugs'' near the
  78.      end of the GNU Emacs reference manual (or Info system) for
  79.      hints on how and when to report bugs.  Also, include the
  80.      version number of the gdb you are running in every bug
  81.      report that you send in.
  82.  
  83.      Do not expect a personal answer to a bug report.  The pur-
  84.      pose of reporting bugs is to get them fixed for everyone in
  85.      the next release, if possible.  For personal assistance,
  86.      look in the SERVICE file (see the GNU Emacs man page) for a
  87.      list of people who offer it.
  88.  
  89.      Please do not send anything but bug reports to this mailing
  90.      list.  Send other stuff to gnu@prep.ai.mit.edu (or the
  91.      corresponding UUCP address).  For more information about GNU
  92.      mailing lists, see the file MAILINGLISTS (see the GNU Emacs
  93.      man page).  Bugs tend actually to be fixed if they can be
  94.      isolated, so it is in your interest to report them in such a
  95.      way that they can be easily reproduced.
  96.  
  97.      No bugs are known at this time.
  98.  
  99.